From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 26 Jul 2025 08:36:16 +0000 (+0300)
Subject: ; Fix documentation of 'other-window'
X-Git-Tag: archive/raspbian/1%30.2+1-2+rpi1^2~2^2~24^2~18
X-Git-Url: https://dgit.raspbian.org/%22http:/www.example.com/cgi/%22https://%22%22/%22http:/www.example.com/cgi/%22https:/%22%22?a=commitdiff_plain;h=e4908623f2351fe00332fba461b779c9a41a70a1;p=emacs.git

; Fix documentation of 'other-window'

* doc/lispref/windows.texi (Cyclic Window Ordering):
* lisp/window.el (other-window): Document ALL-FRAMES in interactive
invocations.
---

diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index f076a6148a7..b4692b98090 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -2088,7 +2088,9 @@ argument.
 
 The optional argument @var{all-frames} has the same meaning as in
 @code{next-window}, like a @code{nil} @var{minibuf} argument to
-@code{next-window}.
+@code{next-window}.  When called interactively, @var{all-frames} is
+always @code{nil}, so only windows on the selected frame can be
+selected.
 
 This function does not select a window that has a non-@code{nil}
 @code{no-other-window} window parameter (@pxref{Window Parameters}),
diff --git a/lisp/window.el b/lisp/window.el
index 6eaa983f4c7..5debf6ef119 100644
--- a/lisp/window.el
+++ b/lisp/window.el
@@ -3973,7 +3973,8 @@ window parameter is non-nil.
 This function uses `next-window' for finding the window to
 select.  The argument ALL-FRAMES has the same meaning as in
 `next-window', but the MINIBUF argument of `next-window' is
-always effectively nil."
+always effectively nil.  Interactively, ALL-FRAMES is always
+nil, which considers all windows on the selected frame."
   (interactive "p\ni\np")
   (let* ((window (selected-window))
          (original-window window)